home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / AMIGA / (A)TB / (A)TBY.ADF / Soundzap / SoundZAP.doc < prev    next >
Text File  |  1992-03-20  |  7KB  |  146 lines
  1. SoundZAP v2.3:
  2.  
  3.  
  4. Description:
  5.   SoundZAP is a program for converting sound files of various formats
  6. into IFF 8SVX files or RAW sample data.
  7.  
  8. Background:
  9.   One of the amazing things about the Amiga is its incredible sound
  10. support. Its BUILT-IN sound hardware is capable of playing sound of
  11. higher quality than most of the add-on sound hardware for other
  12. platforms. So when I got access to InterNet earlier this year I was
  13. amazed that most of the sound files posted in the
  14. alt.binaries.sounds.* newsgroups were NOT posted by Amiga users, and
  15. therefore were not in the Amiga standard IFF 8SVX format.
  16.   I then looked around for a program that would convert these files
  17. into a format that I can use easily (i.e. 8SVX). The largest help
  18. came from Dave Champion (dgc3@midway.uchicago.edu) who gave me a copy
  19. of a program he wrote called "mac2raw". But, that program still only
  20. gave RAW signed data.
  21.  I wanted 8SVX files. So we hacked around a while working on writing
  22. a multi-format sound convertor. Dave and I worked for a few weeks on
  23. it but finally we both got too busy to give it much more thought.
  24. Then two months or so later I got inspiration! I found ulaw28svx, by
  25. Michael Boehnisch (billy@uni-paderborn.de) somewhere. It worked great
  26. for converting ulawed files and it gave me the output I wanted, so I
  27. sat down and re-wrote the program we had been working on before from
  28. scratch. I got the ULAW and RAW convertors to work, and before I knew
  29. it I had what you now have before you!
  30.  
  31. Capabilities:
  32.   This program converts sound files of the following formats: RAW
  33. (signed, unsigned, and ulaw-ed), .AU files, .VOC files, .WAV,
  34. Macintosh, and IFF 8SVX sounds. It outputs either IFF 8SVX files or
  35. RAW data. It auto detects the .VOC, .AU, .WAV, Macintosh, and 8SVX
  36. headers, converting them appropriately. You can force the program
  37. into using a certian sample rate for the output file. You can also
  38. force it ignore any headers and convert the file as if it were just
  39. RAW data. It can use a variable buffer size and convert samples of
  40. any length. There are a few other command line options that will be
  41. discussed later.
  42.  
  43. Command Line Options:
  44.   All options are a minus sign followed by a letter. Some have
  45. numerical arguments which should follow the letter (no space between
  46. the letter and the number).
  47.  
  48.         -w    : Output RAW data, not 8SVX
  49.  
  50.         -s    : Toggle signed/unsigned. This only needs to be used if
  51.                 the program makes a mistake and assumes signed data
  52.                 is unsigned or vice versa.
  53.  
  54.         -n    : This will cause the program to only output the VHDR
  55.                 and BODY chunks, and not the AUTH and ANNO chunks. If
  56.                 a sample player seems to choke on a converted sample
  57.                 try using this option.
  58.  
  59.         -f    : Force the program to assume the input data is RAW.
  60.                 Use this if the header of a file is corrupted and
  61.                 SoundZAP is choking on it. You may then have to edit
  62.                 the sample to get rid of any headers or other
  63.                 non-sample data that doesn't get stripped.
  64.  
  65.         -b<n> : This will change the size of the buffer the program
  66.                 uses while converting the sample. If you have only a
  67.                 small amount of memory you may have to use this
  68.                 switch, but remember: the larger the buffer the
  69.                 faster the conversion. The default is 50K and n is in
  70.                 K, so "-b1024" would create a 1024 kilobyte (or 1
  71.                 Megabyte) buffer. If n is 0 then the program will try
  72.                 to allocate a buffer that is the same size as the
  73.                 sample. This can speed up the conversion of samples
  74.                 quite a bit...if you have enough memory.
  75.  
  76.         -r<n> : This changes the sample rate for the output data.
  77.                 This switch overrides any headers in the source file.
  78.                 Possible values for n are the following:
  79.                                         5  = 5696  samples/sec
  80.                                         7  = 7596  samples/sec
  81.                                         8  = 8000  samples/sec
  82.                                         1  = 11395 samples/sec
  83.                                         2  = 22790 samples/sec
  84.  
  85.                 This switch will also accept explicit declarations of
  86.                 the sample rate, not just the above abbreviations.
  87.                 Just enter the sample rate right after the '-r' on
  88.                 the command line.
  89.                 Example: "-r2203" would set the sample rate to 2203
  90.                 samples per second.
  91.  
  92.                 The default is 11395 samples/sec for RAW data.
  93.  
  94.  
  95. Registration:
  96.     I am not asking for any money for this program. It was not that
  97.     difficult to write and I enjoyed doing it. If YOU feel obligated
  98.     to send something what you could do is send me any information on
  99.     sound formats that you think would be useful for future versions.
  100.     That would probably be the most helpful thing you could do.
  101.  
  102. Updates:
  103.     I will try to keep the most up-to-date versions on FTP sites for
  104.     people with FTP access. Since ab20 went down, I will keep new
  105.     versions on amiga.physik.unizh.ch. If you don't have FTP access I
  106.     can send you the latest version via Internet E-Mail. Finally, I
  107.     can Snail-Mail you the latest version if you have no other way of
  108.     finding it, but you'll have to send me enough money to cover the
  109.     price of a disk and postage. When you get a new version PASS IT
  110.     AROUND! Upload it to BBS's and other FTP sites so people can find
  111.     it!
  112.  
  113. Thanks:
  114.     Thanks to Guido, Michael, Brian Foley. See source for why! And I
  115.     especially want to thank Dave who helped TREMENDOUSLY with the
  116.     first attempt, which was the basis for this version. Also thanks
  117.     to everyone who sent me mail and tested the new versions of this
  118.     program.
  119.  
  120. Author:
  121.     Michael Cramer (mrc113@psuvm.psu.edu | mrc@ecl.psu.edu)
  122.  
  123.     You can contact me at the above E-Mail address from September to
  124.     November and from January to April. You can also Snail-Mail me
  125.     anytime at the following address: 1015 Lindbergh Ave.
  126.                        Stroudsburg, PA 18360
  127.  
  128.     Use E-Mail if you can, becasue it's MUCH faster for me.
  129.  
  130. If you find ANY bugs or things you think should be changed contact me
  131. and I'll to my best to fix them. I would especially like someone to
  132. check out the .VOC conversion stuff because it was basically a stab
  133. in the dark! Please don't make any changes to my source, mail me and
  134. I'll release a fixed version.
  135.  
  136.  
  137. If you have the specifications and/or a sample of another storage
  138. format please mail it to me. I can only support formats that I have
  139. access to, and I don't have time to look all over the place for
  140. different formats. Thanks!
  141.  
  142. See the file "history" for release history and future plans.
  143.  
  144. This version of SoundZAP was compiled with DICE version 2.06.40 in
  145. April of 1992.
  146.